home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 2 / Amiga Tools 2.iso / hardware / vector-connection / development / autodocs / vectorser.doc < prev   
Encoding:
Text File  |  1995-03-09  |  2.1 KB  |  56 lines

  1. TABLE OF CONTENTS
  2.  
  3. vectorser.device/VSCMD_SETCTRLLINES
  4. vectorser.device/VSCMD_SETCTRLLINES       vectorser.device/VSCMD_SETCTRLLINES
  5.  
  6.    NAME
  7.     VSCMD_SetCtrlLines -- set the I/O Control Lines for a serial line.
  8.  
  9.    FUNCTION
  10.     This command allows you to control the status of the I/O lines for a
  11.     serial port. You can set and reset both I/O Lines (DTR and RTS) for
  12.     each port independently. This allows e.g. BBS programs to drop DTR
  13.     without having to rely to the CloseDevice()/OpenDevice() sequence.
  14.  
  15.     If you set a control bit in the io_Offset parameter, then the value
  16.     of the corresponding control bit in the io_Length parameter controls
  17.     the level of the I/O line.
  18.  
  19.     io_Offset Bit == 0  ---> io_Length Bit  does not affect control line.
  20.     io_Offset Bit == 1  ---> io_Length Bit == 1 -> Set Control Line
  21.     io_Offset Bit == 1  ---> io_Length Bit == 0 -> Reset Control Line
  22.  
  23.    IO REQUEST
  24.     io_Message      mn_ReplyPort initialized
  25.     io_Device       preset by OpenDevice
  26.     io_Unit         preset by OpenDevice
  27.     io_Command      VSCMD_SETCTRLLINES (10)
  28.     io_Offset        Bitmask for control lines
  29.     io_Length        Bitmask for setting and resetting the line
  30.  
  31.    RESULT
  32.     none
  33.  
  34.    NOTES
  35.     Setting and resetting RTS is not recommended for normal operation of
  36.     the vectorser.device, but it could be useful if you connect some special
  37.     hardware to a serial port (e.g.  digitizer, clocks or dongle devices).
  38.     In such a case you can use the DTR and RTS lines as general purpose
  39.     output ports (open the device with IOF_7WIRE reset) and the CTS, CD and
  40.     DSR lines as general purpose input lines which can be read with the
  41.     SERCMD_QUERY command.
  42.  
  43.     This command is implemented in a way, which is (according to some 
  44.     articles, which I grabbed from the UseNet) 'ADSG' compatible. This
  45.     means, that this command was first implemented in the driver for an
  46.     I/O board from ADSG. I never had access to a documentation for this
  47.     command, only to code which is supposed to use this driver.
  48.  
  49.    BUGS
  50.     Don't know of any. As I told you, I never had access to *real* ADSG
  51.     documentation.
  52.  
  53.    SEE ALSO
  54.     serial.device/SDCMD_QUERY, devices/vectorser.h
  55.  
  56.